/**
 * @apiDefine tbk 淘宝客
 * @apiHeader {String} token App用户token
 */

/**
 * @api {POST} /app/dg_optimus_material 物料精选
 * @apiSampleRequest /app/dg_optimus_material
 * @apiDescription
 * <p>需要在Header里携带App客户端的用户Token，后台会判断用户是否绑定过淘宝客。</p>
 * <p>响应结果需参考<a href="https://open.taobao.com/api.htm?docId=33947&docType=2">淘宝客-推广者-物料精选</a>文档</p>
 * @apiGroup tbk
 * @apiUse tbk
 * @apiParam {Number} page_no 页码
 * @apiParam {Number} page_size 每页数量
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "code": 0,
 *     "data": {
 *         "map_data": [
 *             {
 *                 "category_id": 201332702,
 *                 "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3D1t4bT%2BdQbKtw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0M3DTZHX%2F6Xa%2FKoEzR7uVlFrGm54tXvqBWf3ZXjAtMwD%2FdaJX1grJf6s1TtvX%2F8tXImAYBbOVEAzUyNpxLfgKr0jWpzpm6nECz1as9dE8xRA%2F4bfyAV05cjUjA6HHqCZzNeHFlpxjvVGdgCjjBOJXdIhhQs2DjqgEA%3D%3D&scm=1007.15348.115058.0_27160&pvid=74837272-1141-493e-984d-7f5e007e26a2&app_pvid=59590_33.3.204.102_863_1643253207855&ptl=floorId:27160;originalFloorId:27160;pvid:74837272-1141-493e-984d-7f5e007e26a2;app_pvid:59590_33.3.204.102_863_1643253207855&union_lens=lensId%3AMAPI%401643253207%4074837272-1141-493e-984d-7f5e007e26a2_593332408680%401",
 *                 "commission_rate": "1.35",
 *                 "coupon_amount": 0,
 *                 "coupon_end_time": "",
 *                 "coupon_remain_count": 0,
 *                 "coupon_start_fee": "0.0",
 *                 "coupon_start_time": "",
 *                 "coupon_total_count": 0,
 *                 "item_description": "气泡丰富  柔软细腻 爆款热销",
 *                 "item_id": 593332408680,
 *                 "ju_online_end_time": "1643644799000",
 *                 "ju_online_start_time": "1642953600000",
 *                 "level_one_category_id": 50008141,
 *                 "level_one_category_name": "酒类",
 *                 "maochao_play_conditions": "2",
 *                 "maochao_play_discount_type": "2",
 *                 "maochao_play_discounts": "750",
 *                 "maochao_play_end_time": "1643299199000",
 *                 "maochao_play_free_post_fee": "1",
 *                 "maochao_play_start_time": "1643212800000",
 *                 "nick": "天猫超市",
 *                 "pict_url": "//img.alicdn.com/bao/uploaded/i3/6000000000461/O1CN01lFD6eR1FHBK8MGfvV_!!6000000000461-0-picassoopen.jpg",
 *                 "reserve_price": "73.6",
 *                 "seller_id": 725677994,
 *                 "small_images": {
 *                     "string": [
 *                         "//img.alicdn.com/i3/6000000000274/O1CN01U3hz0r1DtX639mRoo_!!6000000000274-0-at.jpg",
 *                         "//img.alicdn.com/i2/2200783047612/O1CN01x2rTyv266LOm9JX2y_!!2200783047612-0-scmitem6000.jpg",
 *                         "//img.alicdn.com/i2/2200783047612/O1CN019CIPyA266LRwEZPbq_!!2200783047612-0-scmitem6000.jpg",
 *                         "//img.alicdn.com/i3/2200783047612/O1CN01byuN39266LPwzudtq_!!2200783047612-0-scmitem6000.jpg"
 *                     ]
 *                 },
 *                 "sub_title": "气泡丰富  柔软细腻 爆款热销",
 *                 "title": "慕拉起泡酒少女水果气泡酒莫斯卡托白葡萄酒红酒双支送礼香槟果酒",
 *                 "user_type": 1,
 *                 "volume": 2000,
 *                 "zk_final_price": "59"
 *             },
 *         ]
 *     }
 * }
 * @apiErrorExample {json} 需要绑定淘宝客:
 * {
 *    "code": 500,
 *    "sub_code": "NEED_BIND_TBK",
 *    "msg": "请绑定淘宝客"
 * }
 */

/**
 * @api {POST} /app/dg_material_optional 物料搜索
 * @apiSampleRequest /app/dg_material_optional
 * @apiDescription
 * <p>需要在Header里携带App客户端的用户Token，后台会判断用户是否绑定过淘宝客。</p>
 * <p>响应结果需参考<a href="https://open.taobao.com/api.htm?docId=35896&docType=2">淘宝客-推广者-物料搜索</a>文档</p>
 * @apiGroup tbk
 * @apiUse tbk
 * @apiParam {String} q 商品筛选-查询词
 * @apiParam {Number} page_no 页码
 * @apiParam {Number} page_size 每页数量
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "code": 0,
 *     "data": {
 *         "map_data": [
 *             {
 *                 "category_id": 201160807,
 *                 "category_name": "设计素材/源文件",
 *                 "commission_rate": "135",
 *                 "commission_type": "COMMON",
 *                 "coupon_id": "",
 *                 "coupon_info": "",
 *                 "coupon_remain_count": 0,
 *                 "coupon_total_count": 0,
 *                 "include_dxjh": "false",
 *                 "include_mkt": "false",
 *                 "info_dxjh": "{}",
 *                 "item_description": "",
 *                 "item_id": 570153540562,
 *                 "item_url": "https://item.taobao.com/item.htm?id=570153540562",
 *                 "level_one_category_id": 201156706,
 *                 "level_one_category_name": "商务/设计服务",
 *                 "nick": "黑色千羽鹤",
 *                 "num_iid": 570153540562,
 *                 "pict_url": "https://img.alicdn.com/bao/uploaded/i4/55901646/TB2_WKLtmtYBeNjSspkXXbU8VXa_!!55901646.jpg",
 *                 "presale_deposit": "0",
 *                 "presale_end_time": 0,
 *                 "presale_start_time": 0,
 *                 "presale_tail_end_time": 0,
 *                 "presale_tail_start_time": 0,
 *                 "provcity": "北京",
 *                 "real_post_fee": "0.00",
 *                 "reserve_price": "8",
 *                 "seller_id": 55901646,
 *                 "shop_dsr": 48552,
 *                 "shop_title": "素材王国",
 *                 "short_title": "ui界面背景音效截图",
 *                 "small_images": {
 *                     "string": [
 *                         "https://img.alicdn.com/i3/55901646/TB2NOFYa.3iyKJjSspnXXXbIVXa_!!55901646.jpg",
 *                         "https://img.alicdn.com/i4/55901646/TB2xlF1nXXXXXa6XXXXXXXXXXXX_!!55901646.jpg"
 *                     ]
 *                 }
 *         ],
 *         "total": 253
 *     }
 * }
 * @apiErrorExample {json} 需要绑定淘宝客:
 * {
 *    "code": 500,
 *    "sub_code": "NEED_BIND_TBK",
 *    "msg": "请绑定淘宝客"
 * }
 */

/**
 * @api {POST} /app/tbk_query_goods 物料精选/搜索
 * @apiSampleRequest /app/tbk_query_goods
 * @apiDescription
 * <p>无商品查询词返回物料精选结果，否则返回物料搜索结果</p>
 * @apiGroup tbk
 * @apiUse tbk
 * @apiParam {String} q 商品筛选-查询词
 * @apiParam {Number} page_no 页码
 * @apiParam {Number} page_size 每页数量
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "code": 0,
 *     "data": {
 *         "map_data": [
 *             {
 *                 "category_id": 201160807,
 *                 "category_name": "设计素材/源文件",
 *                 "commission_rate": "135",
 *                 "commission_type": "COMMON",
 *                 "coupon_id": "",
 *                 "coupon_info": "",
 *                 "coupon_remain_count": 0,
 *                 "coupon_total_count": 0,
 *                 "include_dxjh": "false",
 *                 "include_mkt": "false",
 *                 "info_dxjh": "{}",
 *                 "item_description": "",
 *                 "item_id": 570153540562,
 *                 "item_url": "https://item.taobao.com/item.htm?id=570153540562",
 *                 "level_one_category_id": 201156706,
 *                 "level_one_category_name": "商务/设计服务",
 *                 "nick": "黑色千羽鹤",
 *                 "num_iid": 570153540562,
 *                 "pict_url": "https://img.alicdn.com/bao/uploaded/i4/55901646/TB2_WKLtmtYBeNjSspkXXbU8VXa_!!55901646.jpg",
 *                 "presale_deposit": "0",
 *                 "presale_end_time": 0,
 *                 "presale_start_time": 0,
 *                 "presale_tail_end_time": 0,
 *                 "presale_tail_start_time": 0,
 *                 "provcity": "北京",
 *                 "real_post_fee": "0.00",
 *                 "reserve_price": "8",
 *                 "seller_id": 55901646,
 *                 "shop_dsr": 48552,
 *                 "shop_title": "素材王国",
 *                 "short_title": "ui界面背景音效截图",
 *                 "small_images": {
 *                     "string": [
 *                         "https://img.alicdn.com/i3/55901646/TB2NOFYa.3iyKJjSspnXXXbIVXa_!!55901646.jpg",
 *                         "https://img.alicdn.com/i4/55901646/TB2xlF1nXXXXXa6XXXXXXXXXXXX_!!55901646.jpg"
 *                     ]
 *                 }
 *         ],
 *         "total": 253
 *     }
 * }
 * @apiErrorExample {json} 需要绑定淘宝客:
 * {
 *    "code": 500,
 *    "sub_code": "NEED_BIND_TBK",
 *    "msg": "请绑定淘宝客"
 * }
 */
